QUICKSTART

0) Have FXRuby installed
1) Take a look at test/widgets.xul
2) Run, from the top directory:
	ruby -I. test/xul.rb
3) Take a look at test/work.rb
4) Run:
	ruby -I. test/work.rb
5) Read docs/xul.txt
6) docs/diagrams/* may be interesting.
7) Comment.  Contribute.

OVERVIEW

I've written this proof-of-concept based on information gleaned from
the Rouge forum.  This is not meant to be the culmination of those
discussions, and nobody has endorsed this design but me.  This is 
a work that is very much open to comment.  Please keep the following
in mind:

* Rouge is the Alpha layer.  This release, by neccessity, also includes
	an omega layer. 
* Rouge contains two APIs.  One is native Ruby; the other is a XUL-like
	interpreter for XML GUI descriptions.
* Until I write a diagram, this is how it works: both of the Alpha APIs
  use the Omega API to construct the interface.  The Omega API calls
	the native binding to create the actual widgets.  This means that
	the native bindings only need to be written once.
* There is, currently, only one Omega binding for FXRuby.  One of my top
	priorities is to add bindings to this package; the goal is to have a
	binding for every native toolkit available for Ruby (Mwuahahahaha!)
	Volunteers in this area are greatly appreciated.  NOTE that as soon
	as you write an Omega binding, assuming it doesn't contain any bugs,
	any Rouge app should be able to use that binding.
* The XUL interface is only quasi-XUL.  See docs/xul.txt.
* The native Ruby API is, IMHO, as simple as possible.  Due to the loosely
	typed nature of Ruby, introspection is nearly worthless for creating
	an intelligent GUI-from-object builder.  The next best thing (again,
	IMO) is a nested-construction metaphor.  This works very well in the
	CGI package for Ruby, as well as being proved by the Amiga's MUI API.
	Nested construction metaphors maintain much of the quasi-ontological
	relationships between object instances in the visual structure of the
	code itself, which is a strong argument for using them.  This structure
	was first proposed for Rouge by Rich Kilmer, although I've diverged
	from his syntax.
